<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-us" lang="en-us">
<head profile="http://gmpg.org/xfn/11">
<title>Barthelme &middot; An explanation</title>
<meta http-equiv="content-type" content="text/html; charset=UTF-8" />
<meta name="description" content="Barthelme: Where white space and margins show culture and aestheticism." />
<meta name="keywords" content="barthelme, theme, wordpress, plaintxt.org, semantics, widgets, hatom, hcard, xfn" />
<style type="text/css" media="screen,projection">
/*<![CDATA[*/
	body{color:#222;font:80%/150% verdana,geneva,sans-serif;margin:2em auto;padding:0;}
	body blockquote{background:#f5F5F5;font-size:1em;padding:0.5em 1em;text-indent:2em;}
	body blockquote p{margin:0.5em 0;line-height:150%;}
	body blockquote,body h3,body h4,dl dt.def-head,body div.readme-subtitle{color:#000;font-family:georgia,times,serif;}
	body code{font:1em/133% "courier new",courier,monospace;}
	body div.readme{margin:0 auto 10em;width:40em;}
	body div.readme-subtitle{color:#000;line-height:150%;margin:0 25%;padding:1em 0;}
	body div.readme-version{color:#888;}
	body h2{color:#8b9baf;font:normal 3.2em/150% arial,helvetica,sans-serif;letter-spacing:3px;margin:0;text-align:center;}
	body h3{font:1.7em/133% georgia,times,serif;margin:2em 0 -0.5em;}
	body h4{font-size:1.4em;font-style:italic;font-weight:400;line-height:150%;margin:1em 0 -0.5em;}
	body ol#toc h3{margin-bottom:0;}
	body ol li form{float:left;margin:1.5em 1em 0 0;}
	body p{margin:1em 0;}
	body p.rubric{margin:1em 0 0.2em;}
	div.readme-meta{font-size:0.9em;letter-spacing:2px;line-height:133%;text-align:center;}
	dl{background:#eee;padding:1em;}
	dl dd{margin:0;padding:0;}
	dl dd code{color:#666;font-size:0.9em;}
	dl dd.example{margin-left:1em;margin-bottom:2em;}
	dl dt code{display:block;font-size:1.1em;margin:0.3em 0;}
	dl dt.rubric{margin-top:1em;}
	dl dt.def-head{font-size:1.2em;font-weight:bold;line-height:150%;margin-left:-1em;margin-right:-1em;padding:0 1em 0;}
	dl dd.def-rubric{border-bottom:2px solid #fff;line-height:150%;font-style:italic;margin-left:-1em;margin-right:-1em;padding:0 1em 0.5em;}
/*]]>*/
</style>
<style type="text/css" media="all">
/*<![CDATA[*/
	body blockquote strong{text-transform:uppercase;}
	body div.readme p#friends span.family-name{display:none;}
	body ol#toc{list-style:lower-roman;}
	body ul li{list-style:square;}
	body ul li ul li{list-style:circle;}
	body ol.item-examples li{list-style:lower-alpha;}
	dl{margin:1em 0 2em;}
	div#theme-meta span{display:block;margin:0.2em 0;}
	dl#emphasis dd em{font-style:normal;font-weight:700;}
	dl#emphasis dd strong{font-size:0.9em;letter-spacing:0.4px;text-transform:uppercase;}
	dl dd a.download{background:url(images/file-download.png) no-repeat center left;padding-left:19px;}
	dl dd p.html{background:url(images/file-html.png) no-repeat center left;padding-left:19px;margin:0;}
	dl dd span.pdf{background:url(images/file-pdf.png) no-repeat center left;padding-left:19px;margin:0;}
	dl dd a.zip{background:url(images/file-zip.png) no-repeat center left;padding-left:19px;margin:0;}
	dl dd p.important{background:#f5f5dc url(images/important.png) no-repeat 0.5em center;border-bottom:1px solid #d0d0bb;border-top:1px solid #d0d0bb;padding:0.2em 0.5em 0.2em 2.2em;margin:0;}
	dl dd span.caps{font-variant:small-caps;}
/*]]>*/
</style>
</head>
<body>
<div class="readme">
	<h2 id="readme-title">Barthelme</h2>
	<div class="readme-meta">
		<div class="readme-version">Version 4.5.2</div>
		<div class="readme-subtitle">Where white space and margins show culture and aestheticism</div>
	</div>
	<ol id="toc">
		<li>
			<h3>Table of contents</h3>
			<ol class="readme-menu">
				<li><a href="#about" title="About Barthelme">About Barthelme</a></li>
				<li><a href="#installing" title="Installing the theme">Installing the theme files</a></li>
				<li><a href="#enabling" title="Enabling comments / author link on pages">Enabling comments / author byline on pages</a></li>
				<li><a href="#using" title="Using page templates">Using page templates</a></li>
				<li><a href="#customizing" title="Customizing the sidebar">Customizing the sidebar</a></li>
				<li><a href="#special" title="Special classes and styled elements">Special classes and styled elements</a></li>
				<li><a href="#standards" title="Standards compliance">Standards compliance</a></li>
				<li><a href="#license" title="License information">License information</a></li>
				<li><a href="#development" title="Development and help">Development and help</a></li>
				<li><a href="#credits" title="Credits and thanks">Credits and thanks</a></li>
			</ol>
		</li>
	</ol>
	<ol id="readme-content">
		<li id="about">
			<h3>About Barthelme</h3>
			<p><a href="http://www.plaintxt.org/themes/barthelme/" title="Barthelme for WordPress">Barthelme</a> is a fluid, two-column theme for <a href="http://wordpress.org/" title="WordPress">WordPress</a> with many features. It's about presenting the content in a slightly different way, using white space as a major design element.</p>
			<p>Barthelme version 4.5 is compatible with Wordpress 2.5.x.</p>
			<p class="rubric">Barthelme features:</p>
			<ul id="features">
				<li>a theme options menu, which allows
					<ul>
						<li>control over fonts and text size</li>
						<li>control over the the banner design</li>
						<li>control over the layout and alignment</li>
					</ul>
				</li>
				<li><a href="http://en.wikipedia.org/wiki/Web_standards" title="Web standards on Wikipedia">standards compliance</a> with
					<ul>
						<li><a href="http://en.wikipedia.org/wiki/Cascading_Style_Sheets" title="CSS on Wikipedia">CSS</a> 2.1</li>
						<li><a href="http://microformats.org/wiki/hatom" title="hAtom microformat">hAtom 0.1</a></li>
						<li><a href="http://microformats.org/wiki/hcard" title="hCard microformat">hCard</a></li>
						<li><a href="http://en.wikipedia.org/wiki/XHTML" title="XHTML">XHTML</a> 1.0 Transitional</li>
					</ul>
				</li>
				<li>option for enabling comments on pages</li>
				<li>option for enabling author bylines on pages</li>
				<li>a robust stylesheet and separate print stylesheet</li>
				<li>highly <a href="http://en.wikipedia.org/wiki/Semantic_web" title="Semantic web on Wikipedia">semantic markup</a></li>
				<li>latest Widgets compatibility</li>
			</ul>
			<h4>About Donald Barthelme</h4>
			<p>Besides being a personal favorite, others seem to enjoy <a href="http://en.wikipedia.org/wiki/Donald_Barthelme" title="Donald Barthelme - Wikipedia">Donald Barthelme's</a> punchy and cerebral short stories. I have no time to pin a genre to him. He's odd, his stories are ridiculous, and I've named this theme in honor of him and his short story "Margins" (the first in the <cite>60 Stories</cite> collection).</p>
			<p class="rubric">Learn more about Barthelme (and read his stories) by visiting:</p>
			<ul>
				<li><a href="http://www.jessamyn.com/barth/" title="jessamyn.com : Donald Barthelme's barthelmismo">jessamyn's Barthelmismo</a></li>
				<li><a href="http://www.coldbacon.com/barthelme.html" title="Donald Barthelme - ColdBacon">Barthelme - ColdBacon</a></li>
				<li><a href="http://www.themodernword.com/scriptorium/barthelme.html" title="Scriptorim: Donald Barthelme">Barthelme on Scriptorium</a></li>
			</ul>
		</li>
		<li id="installing">
			<h3>Installing the theme files</h3>
			<p>The theme is installed just like any other WordPress theme. You can read more detailed installation instructions on the WordPress Codex in <a href="http://codex.wordpress.org/Using_Themes#Adding_New_Themes" title="Adding new themes - WordPress Codex">Adding New Themes</a>.</p>
			<p>If you are upgrading from an older version, first reset the theme options in the <i>Theme Options</i> submenu. Then delete <em>all</em> the Barthelme theme files and folders before uploading the new version.</p>
			<p class="rubric">To install the theme:</p>
			<ol>
				<li>Download <a href="http://www.plaintxt.org/themes/barthelme/" title="Barthelme for WordPress">Barthelme</a></li>
				<li>Extract the <code>/barthelme/</code> folder from the archive</li>
				<li>Upload this folder to the <code>/wp-contents/themes/</code> directory</li>
				<li>Activate the theme in the <i>Dashboard &rsaquo; Design</i> menu</li>
				<li>After activating, the <i>Design &rsaquo; Theme Options</i> will appear</li>
				<li>Enjoy. And then consider donating.</li>
			</ol>
			<h4>Support and donations</h4>
			<form id="paypal" action="https://www.paypal.com/cgi-bin/webscr" method="post">
				<div id="donate">
					<input type="hidden" name="cmd" value="_s-xclick" />
					<input type="image" name="submit" src="https://www.paypal.com/en_US/i/btn/x-click-butcc-donate.gif" alt="Donate with PayPal - it's fast, free and secure!" />
					<img src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1" alt="Donate with PayPal" />
					<input type="hidden" name="encrypted" value="-----BEGIN PKCS7-----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-----END PKCS7-----" />
				</div>
			</form>
			<p>If you would like to support this theme or just say "Thanks," please consider donating. Voluntary support from users is what makes providing WordPress themes possible, so consider throwing a few bucks my way. Even the smallest donations are earnestly appreciated.</p>
		</li>
		<li id="enabling">
			<h3>Enabling comments / author byline on pages</h3>
			<p><a href="http://codex.wordpress.org/Pages" title="Pages - WordPress Codex">Pages</a> are usually considered static in blogging and different from posts, which are what make a blog a blog. Comments are not displayed on pages by default and the author's name is also omitted; however, you can enable both of these features with this theme.</p>
			<h4>Comments on pages</h4>
			<p>Comments are not displayed on pages by default, but are displayed on posts per convention. You can enabled comments on a per page basis by adding a key/value with the text "comments."</p>
			<p class="rubric">To enable comments on a page:</p>
			<ol>
				<li>In the <i>Write &rsaquo; Page</i> menu, expand the <a href="http://codex.wordpress.org/Using_Custom_Fields" title="Custom Fields - WordPress Codex">Custom Fields</a> box</li>
				<li>In the Custom Fields box, add a new key with the exact text: <code>comments</code></li>
				<li>Add any text for a value (some text must be included for the key to save)</li>
				<li>Click <i>Add Custom Field</i> to save the key/value</li>
				<li>Comments should now be enabled on that page</li>
			</ol>
			<p>Enabling comments simply attaches the <code>comments.php</code> file to the page. You can turn off comments on a page by deleting the <code>comments</code> key/value. This does not delete any exisiting comments, but simply disables them from loading with the page.</p>
			<h4>Author byline on pages</h4>
			<p>You may add an author <a href="http://en.wikipedia.org/wiki/Byline" title="Byline - Wikipedia">byline</a> on a per page basis by adding a key/value with the text "authorlink".</p>
			<p class="rubric">To enable an author link on a page:</p>
			<ol>
				<li>In the <i>Write &rsaquo; Page</i> menu, expand the <a href="http://codex.wordpress.org/Using_Custom_Fields" title="Custom Fields - WordPress Codex">Custom Fields</a> box</li>
				<li>In the Custom Fields box, add a new key with the exact text: <code>authorlink</code></li>
				<li>Add any text for a value (some text must be included for the key to save)</li>
				<li>Click <i>Add Custom Field</i> to save the key/value</li>
				<li>An author byline should now be enabled on that page</li>
			</ol>
			<p>This function is related to the <i>Author link</i> option in the <i>Design &rsaquo; Theme Options</i> submenu. If you have selected "Displayed" for the <i>Author link</i> option, then an author byline on a page will include a link to the author's archives. If you have selected "Hidden," the author byline will appear but without any link. Magic!</p>
		</li>
		<li id="using">
			<h3>Using page templates</h3>
			<p>There are three <a href="http://codex.wordpress.org/Pages#Page_Templates" title="Page templates - WordPress Codex">page templates</a> included with the Barthelme theme: Archives Page (archives.php), Links Page (links.php), and Sitemap Page (sitemap.php). You can add a title, text, and enable comments and/or an author bylines (see above) with page templates.</p>
			<p class="rubric">To use the page templates:</p>
			<ol>
				<li>In the <i>Write &rsaquo; Page</i> menu, expand the Page Templates box</li>
				<li>From the drop-down, select the page template to use</li>
				<li>Add a title and text (optional) for the page</li>
				<li>Click <i>Create New Page / Save</i> to publish the page</li>
			</ol>
			<p>The Archive Page displays archives by month and by category (with a link to each category RSS feed). The Links Page displays all the links by link category. The Sitemap Page produces an exhaustive list of all pages and all posts, and lists all category, monthly, and tag archives.</p>
		</li>
		<li id="customizing">
			<h3>Customizing the sidebar</h3>
			<p>For complete control over the sidebar without editing the theme files, use the <i>Design &rsaquo; Widgets</i> menu options. Here you have complete control over the sidebar content.</p>
			<p>The Barthelme theme will correctly display all of the default widgets. There are, however, hundreds of other widgets available that do all sorts of things; therefore, some widgets will require additional CSS declarations to be added to the <code>style.css</code> file.</p>
			<p>Unforunately I can't write <a href="http://en.wikipedia.org/wiki/Cascading_Style_Sheets" title="CSS on Wikipedia">CSS</a> for other widgets/plugins. I can't help you <em>learn</em> CSS, but I can help you <em>use</em> CSS.</p>
			<p class="rubric">For help learning CSS, visit:</p>
			<ul>
				<li><a href="http://www.cssbasics.com/" title="CSS Basics.com">CSS Basics.com</a></li>
				<li><a href="http://www.htmldog.com/guides/cssbeginner/" title="HTML Dog's CSS Beginner Tutorial">HTML Dog's CSS Beginner Tutorial</a></li>
				<li><a href="http://www.html.net/tutorials/css/" title="HTML.net's CSS Tutorial">HTML.net's CSS Tutorial</a></li>
				<li><a href="http://www.w3schools.com/css/default.asp" title="W3's CSS School">W3's CSS School</a></li>
				<li><a href="http://www.stylegala.com/features/css-reference/" title="Stylegala's CSS Reference">Stylegala's CSS Reference</a></li>
			</ul>
			<p>The Barthelme theme automatically replaces a few of the default widgets that come with the Widgets plugin, e.g., Meta, Links, Search, with ones that match the default Barthelme sidebar style.</p>
			<p>Similarly the theme also automatically loads some of its own widgets, e.g., RSS Links, Home Link. This allows the default Barthelme sidebar to be completely replicated using the Widgets.</p>
		</li>
		<li id="special">
			<h3>Special classes and styled elements</h3>
			<p>The Barthelme theme stylesheet (the <code>/barthelme/style.css</code> file) includes specific styles for some special classes and many HTML elements. Some explanation may be helpful for some of the styled HTML elements.</p>
			<p>Note that these classes and elements won't work correctly when entered into the <a href="http://codex.wordpress.org/Your_Profile_SubPanel" title="Your profile - WordPress Codex">visual rich editor</a>. I highly recommend disabling the visual rich editor feature in your user profile.</p>
			<h4>Styled elements</h4>
			<p>The Barthelme theme includes information for many, many HTML elements (e.g., <code>blockquote</code>, <code>q</code>, <code>ins</code>, <code>del</code>) but it may be useful to note how Barthelme handles two particular HTML elements: <code>em</code> and <code>strong</code>.</p>
			<p>I would like to promote semantic markup in blogging. It helps make the content more accessible, consistent, and future-friendly. This theme considers <code>em</code> (emphasis) different from <code>i</code> (italics), and <code>strong</code> (strong emphasis) different from <code>b</code> (bold).</p>
			<p>Bold and italics refer to the appearance of the text, whereas <code>em</code> and <code>strong</code> refer to levels of <a href="http://www.thefreedictionary.com/emphasis" title="Emphasis on freedictionary.com">emphasis</a> put on the word(s). It's the difference between presentation (<code>b</code>/<code>i</code>) and meaning/context (<code>em</code>/<code>strong</code>).</p>
			<ol class="item-examples">
				<li>I shouted <code>&lt;strong&gt;</code><strong>stop doing that!!</strong><code>&lt;/strong&gt;</code></li>
				<li>Did you read the <code>&lt;b&gt;</code><b>readme.html</b><code>&lt;/b&gt;</code> file?</li>
			</ol>
			<p>In item a, the <code>strong</code> element denotes strong emphasis and adds meaning/context to the words. In item b, the <code>b</code> element simply bolds the text and is purely cosmetic.</p>
			<p>Imagine if someone were reading your blog aloud. You would want them to shout "stop doing that!" but not to shout "readme.html!" right?</p>
			<p>Below are examples of how the <code>em</code>, <code>strong</code> and <code>b</code>, <code>i</code> elements have been styled for Barthelme:</p>
			<dl id="emphasis">
				<dt class="def-head">Emphasis</dt>
				<dd class="def-rubric">Used to add meaning and context to text</dd>
				<dt><code>em</code></dt>
				<dd>Used to indicate emphasis</dd>
				<dd class="example">You <code>&lt;em&gt;</code><em>should not</em><code>&lt;/em&gt;</code> be late.</dd>
				<dt><code>strong</code></dt>
				<dd>Used to indicate stronger emphasis</dd>
				<dd class="example">He shouted <code>&lt;strong&gt;</code><strong>You're fired!</strong><code>&lt;/strong&gt;</code></dd>
			</dl>
			<dl id="presentation">
				<dt class="def-head">Presentation</dt>
				<dd class="def-rubric">Used to style text (not to add meaning)</dd>
				<dt><code>b</code></dt>
				<dd>Used to bold text</dd>
				<dd class="example">Find the word <code>&lt;b&gt;</code><b>happy</b><code>&lt;/b&gt;</code> in the glossary.</dd>
				<dt><code>i</code></dt>
				<dd>Used to italicize text</dd>
				<dd class="example">Go to the <code>&lt;i&gt;</code><i>Presentation</i><code>&lt;/i&gt;</code> subpanel.</dd>
			</dl>
			<p class="rubric">For more information on how to write semantic markup in your blog, visit:</p>
			<ul>
				<li><a href="http://brainstormsandraves.com/articles/semantics/structure/" title="Semantics, XHTML, and Structure">Brainstorms &amp; Raves: Semantics, XHTML, and Structure</a></li>
				<li><a href="http://www.mezzoblue.com/downloads/markupguide/" title="mezzoblue &sect; markup guide">mezzoblue &sect; markup guide</a></li>
			</ul>
			<h4>Headings</h4>
			<p>Headings for the content area have been styled to display correctly: with more space above than below as content must logically follow headings. Headings help create an outline of the content on your page. They guide the reader and also help machines understand the structure of content.</p>
			<p>While there are no hard-and-fast rules regarding this, I believe the headings should follow a logical progression, e.g., <i>h1 &rsaquo; h2 &rsaquo; h3 &rsaquo; h4 &rsaquo; h3 &rsaquo; h3 &rsaquo; h4 &hellip; </i>. There should not be two <code>h1</code>-level headings on a single page. Therefore, since post and page titles are <code>h2</code>-level, the only headings that should be used in the content area are <code>h3</code>&ndash;<code>h6</code>.</p>
			<h4>Special classes</h4>
			<p>There are certain conventions amongst many WordPress themes for special classes. Notably common are the image classes. Again, these won't work correctly if entered directly into the visual rich editor.</p>
			<p>You should have a basic understanding of HTML before using these classes. I won't be able to help you <em>learn</em> HTML. I can, however, help you <em>use</em> HTML.</p>
			<dl id="alignment">
				<dt class="def-head">Alignment classes</dt>
				<dd class="def-rubric">Used to align elements, notably images</dd>
				<dt class="rubric"><b>alignleft</b> - Floats element to the left, e.g.,</dt>
				<dt class="classes">
					<code>&lt;img class=&quot;<b>alignleft</b>&quot; &hellip; /&gt;</code>
					<code>&lt;p class=&quot;<b>alignleft</b>&quot; &hellip; /&gt;</code>
				</dt>				
				<dd class="example-code"><pre>	XXXXXXX
	&#8968;&#175;&#8969; XXX
	&#8970;_&#8971; XXX
	XXXXXXX</pre></dd>
				<dd class="example"><code>&lt;img <b>class=&quot;alignleft&quot;</b> src=&quot;http://www.example.com/example.jpg&quot; alt=&quot;Example&quot; /&gt;</code></dd>
				<dd class="rubric"><b>alignright</b> - Floats element to the right, e.g.,</dd>
				<dt class="classes">
					<code>&lt;img class=&quot;<b>alignright</b>&quot; &hellip; /&gt;</code>
					<code>&lt;div class=&quot;<b>alignright</b>&quot; &hellip; /&gt;</code>
				</dt>
				<dd class="example-code"><pre>	XXXXXXX
	XXX &#8968;&#175;&#8969;
	XXX &#8970;_&#8971;
	XXXXXXX</pre></dd>
				<dd class="example"><code>&lt;img <b>class=&quot;alignright&quot;</b> src=&quot;http://www.example.com/example.jpg&quot; alt=&quot;Example&quot; /&gt;</code></dd>
				<dt class="rubric"><b>center</b> - Centers element as a block, e.g.,</dt>
				<dt class="classes">
					<code>&lt;img class=&quot;<b>center</b>&quot; &hellip; /&gt;</code>
					<code>&lt;span class=&quot;<b>center</b>&quot; &hellip; /&gt;</code>
				</dt>
				<dd><pre>	XXXXXXX
	  &#8968;&#175;&#8969;  
	  &#8970;_&#8971;  
	XXXXXXX</pre></dd>
				<dd class="example"><code>&lt;img <b>class=&quot;center&quot;</b> src=&quot;http://www.example.com/example.jpg&quot; alt=&quot;Example&quot; /&gt;</code></dd>
				<dt class="rubric"><b>content-column</b> - Sets element in column (Should be used with one of the elements above), e.g.,</dt>
				<dt class="classes">
					<code>&lt;p class=&quot;<b>content-column alignleft</b>&quot; &hellip; /&gt;</code>
					<code>&lt;div class=&quot;<b>content-column alignright</b>&quot; &hellip; /&gt;</code>
				</dt>
				<dd class="example"><code>&lt;div <b>class=&quot;content-column alignright&quot;</b>&gt; &hellip; &lt;/div&gt;</code></dd>
			</dl>
			<dl id="file">
				<dt class="def-head">Icon element classes</dt>
				<dd class="def-rubric">Used to add a <a href="http://www.famfamfam.com/lab/icons/silk/" title="Silk icons by Fam Fam Fam">Silk icon</a> to any HTML element</dd>
				<dt class="rubric"><b>download</b> - Adds a download icon, e.g.,</dt>
				<dt class="classes">
					<code>class="<b>download</b>"</code>
				</dt>
				<dd><a class="download" href="http://example.com/example-file">Download this file</a></dd>
				<dd class="example"><code>&lt;a <b>class=&quot;download&quot;</b> href=&quot;http://example.com/example-file&quot;&gt;Download this file&lt;/a&gt;</code></dd>
				<dt class="rubric"><b>html</b> - Adds an html (web) icon, e.g.,</dt>
				<dt class="classes">
					<code>class="<b>html</b>"</code>
				</dt>
				<dd><p class="html">This webpage is great!</p></dd>
				<dd class="example"><code>&lt;p <b>class=&quot;html&quot;</b>&gt;This webpage is great!&lt;/p&gt;</code></dd>
				<dt class="rubric"><b>pdf</b> - Adds a pdf icon, e.g.,</dt>
				<dt class="classes">
					<code>class="<b>pdf</b>"</code>
				</dt>
				<dd>The <span class="pdf">Adobe pdf</span> is a &hellip;</dd>
				<dd class="example"><code>The &lt;span <b>class=&quot;pdf&quot;</b>&gt;Adobe pdf&lt;/span&gt; is a &amp;hellip;</code></dd>
				<dt class="rubric"><b>zip</b> - Adds a zip (compressed archive) icon, e.g.,</dt>
				<dt class="classes">
					<code>class="<b>zip</b>"</code>
				</dt>
				<dd><a class="zip" href="http://example.com/example-zip">Get the zip</a></dd>
				<dd class="example"><code>&lt;a <b>class=&quot;zip&quot;</b> href=&quot;http://example.com/example-zip&quot;&gt;Get the zip&lt;/a&gt;</code></dd>
			</dl>
			<dl id="misc">
				<dt class="def-head">Micellaneous classes</dt>
				<dd class="def-rubric">Other presentational classes that can be applied to elements</dd>
				<dt class="rubric"><b>important</b> - Adds an info icon and other styles, e.g.,</dt>
				<dt class="classes">
					<code>class="<b>important</b>"</code>
				</dt>
				<dd><p class="important">Lorem ipsum importanto habeo inciderint mei at &hellip;</p></dd>
				<dd class="example"><code>&lt;p <b>class=&quot;important&quot;</b>&gt;Lorem ipsum importanto habeo inciderint mei at &amp;hellip;&lt;/p&gt;</code></dd>
				<dt class="rubric"><b>caps</b> - Used to style text in small-caps, e.g.,</dt>
				<dt class="classes">
					<code>class="<b>caps</b>"</code>
				</dt>
				<dd>I work at <span class="caps">Ini-Tech</span> &hellip;</dd>
				<dd class="example"><code>I work at &lt;span <b>class=&quot;caps&quot;</b>&gt;Ini-Tech&lt;/span&gt; &amp;hellip;</code></dd>
			</dl>
		</li>
		<li id="standards">
			<h3>Standards compliance</h3>
			<p>The Barthelme theme is compliant with both XHTML and CSS standards. What does this mean? An explanation of web standards from <cite title="Web Standards Project"><a href="http://webstandards.org" title="Web Standards Project">The Web Standards Project</a></cite>:</p>
			<blockquote cite="http://webstandards.org/learn/faq/" title="What are web standards and why should I use them?">
				<p>Complying with web standards can give your web pages greater visibility in web searches. The structural information present in compliant documents makes it easy for search engines to access and evaluate the information in those documents, and they get indexed more accurately.</p>
				<p>Accessibility is an important idea behind many web standards. Not only does this mean allowing the web to be used by people with disabilities, but also allowing web pages to be understood by people using browsers other than the usual ones &mdash; including voice browsers that read web pages aloud to people with sight impairments, Braille browsers, hand-held browsers, teletext displays, and other unusual output devices.</p>
			</blockquote>
			<p>You can read more about developing with web standards at <a href="http://www.456bereastreet.com/lab/developing_with_web_standards/webstandards/" title="Developing with web standards">456 Berea Street</a>.</p>
			<h4>hAtom microformat</h4>
			<p>In addition to XHTML and CSS web standards, the Barthelme theme implements the <a href="http://microformats.org/wiki/hatom" title="hAtom - Microformats">hAtom 0.1</a> microformat. <a href="http://microformats.org/" title="Microformats">Microformats</a> are markup that express semantic information in webpages.</p>
			<p>Programs can extract information from webpages marked up in a microformat much like feed readers extract information from Atom or RSS syndicated feeds.</p>
			<h4>hCard microformat</h4>
			<p><a href="http://microformats.org/wiki/hcard" title="hCard - Microformats">hCard</a> is a microformat that expresses basic contact information much like a <a href="http://en.wikipedia.org/wiki/VCard" title="vCard - Wikipedia">vCard</a>, except within your blog itself. Basically this is done by using <code>span</code>'s with certain class attributes.</p>
			<p>The first name, last name, and website information for the <i>admin</i> user is automatically used to create an hCard that is placed in the footer and followed by basic copyright information.</p>
			<p>The hCard microformat is used throughout the theme, actually, for author links, bylines, and comment authors. You don't need to do anything, as basically hAtom and hCard are ways of making your blog <a href="http://kitchen.technorati.com/search/" title="Technorati Microformats Search">more accessible</a>.</p>
		</li>
		<li id="license">
			<h3>License information</h3>
			<p>The Barthelme theme, &copy; 2006&ndash;2008 <span class="vcard"><a class="url fn n" href="http://scottwallick.com/"><span class="given-name">Scott</span> <span class="additional-name">Allan</span> <span class="family-name">Wallick</span></a></span>, is licensed under the <cite title="GNU General Public License"><a href="license.txt" title="GNU General Public License" rel="license">GNU General Public License</a></cite>:</p>
			<blockquote cite="http://www.gnu.org/licenses/gpl.html" title="GNU General Public License">
				<p>This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.</p>
				<p>This program is distributed in the hope that it will be useful, but <strong>without any warranty</strong>; without even the implied warranty of <strong>merchantability</strong> or <strong>fitness for a particular purpose</strong>.  See the GNU General Public License for more details.</p>
				<p>You should have received a copy of the GNU General Public License along with this program.  If not, see <a href="http://www.gnu.org/licenses/" title="GNU General Public License" rel="license">http://www.gnu.org/licenses/</a>.</p>
			</blockquote>
			<p>Please feel free to alter the Barthelme theme in any way that pleases you. All I ask is that you allow my original design credit to remain.</p>
		</li>
		<li id="development">
			<h3>Development and help</h3>
			<p>If something isn't working correctly with this theme, please visit <a href="http://code.google.com/p/barthelme/" title="Barthelme - Google Code">Barthelme on Google Code</a>, the project home, to file issues, report problems, help create documentation, etc., because the more everyone shares, the better things can be.</p>
			<p>You can also access the Barthelme <a href="http://en.wikipedia.org/wiki/Subversion" title="Subversion - Wikipedia">Subversion</a> repo, which hosts pre-release fixes and allows changes to be tracked. Please ignore if unfamiliar with Subversion.</p>
			<p>Please feel free to send me an <a href="http://www.plaintxt.org/contact/" title="Contact Scott">email</a> if you're having a problem; however, I will ask that you start an issue on the Barthelme project home (see above) before problem solving. Thanks.</p>
		</li>
		<li id="credits">
			<h3>Credits and thanks</h3>
			<p id="friends">A special thanks goes to <span class="vcard"><a class="url fn n" href="http://andy.wordpress.com/" rel="colleague friend"><span class="given-name">Andy</span><span class="family-name"> Skelton</span></a></span>, who taught me heaps. Andy I collaborated to create the <a href="http://www.plaintxt.org/themes/sandbox/" title="Sandbox theme for WordPress">Sandbox</a>. Thanks to <span class="vcard"><a class="url fn n" href="http://www.mackrick.co.uk/" rel="colleague friend"><span class="given-name">Rick</span><span class="family-name"> Lee</span></a></span> for his thoughtful feedback. And to <span class="vcard"><a class="url fn n" href="http://archgfx.net/" rel="colleague friend"><span class="given-name">Adam</span><span class="family-name"> Freetly</span></a></span> for helping me see 20 things I had to fix. The <code>header-img.php</code> was adapted from <a href="http://binarybonsai.com/wordpress/kubrick/" title="Kubrick for WordPress">Kubrick</a> by <span class="vcard"><a class="url fn n" href="http://binarybonsai.com/" title="Binari Bonsai"><span class="given-name">Michael</span><span class="family-name"> Heilemann</span></a></span>.</p>
			<h4>Icons</h4>
			<p>The file icons are from the <a href="http://www.famfamfam.com/lab/icons/silk/" title="famfamfam.com: Silk Icons">Silk Icons</a> collection by <span class="vcard"><a class="url fn n" href="http://www.famfamfam.com/"><span class="given-name">Mark</span> <span class="family-name">James</span></a></span>. The feed icon (unused but included) is from the <a href="http://www.feedicons.com/">Feed Icons</a> collection by <span class="vcard"><a class="url fn n" href="http://mattbrett.com/"><span class="given-name">Matt</span> <span class="family-name">Brett</span></a></span>.</p>
		</li>
	</ol>
</div>
</body>
</html>